home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 185 (1991-12-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 185 (1991-12-10)(Manewaldt, A.)(DE)(PD).adf / PowerP-Tools / PPMore18a.doc / PPMore18a.doc
Text File  |  1991-11-30  |  16KB  |  368 lines
  1.  
  2.  
  3.                            PPMore 1.8a User Manual
  4.  
  5.                                  Sep 28, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15. This program cannot be used for commercial purposes without written permission
  16. from the author.
  17.  
  18.  
  19.    Coverdisks or diskmagazines need written permission of UGA to offer the
  20. Powerpacker utilities or Powerpacker/Reqtools libraries on their disk. For
  21. commercial use please read the copyright file on your original PP disk.
  22.  
  23.  
  24.  
  25.      If you have suggestions or remarks about this program, or if you find
  26. any bugs, please let me know.
  27.  
  28.      Write to the following address:
  29.  
  30.                                 Nico François
  31.                                 Corbielaan 13
  32.                                 B-3060 Bertem
  33.                                 BELGIUM
  34.  
  35.  
  36. Contents
  37. ========
  38.  
  39. 1. An introduction
  40.  
  41. 2. Usage
  42.  
  43. 3. Control
  44.  
  45. 4. Using PPMore from other programs
  46.  
  47.  
  48. 1. An introduction
  49. ==================
  50.  
  51.      This program was written to complement one of my other utilities,
  52. PowerPacker (a command and data cruncher).  It is used to read normal ascii
  53. text files or text files crunched with PowerPacker.  The program itself is
  54. about 10K long and when you know you save about 60% when you crunch a text
  55. file, you can see that this could save a lot of space on your disks.
  56.      PPMore was written as a more replacement (as you could have guessed :-),
  57. so I tried to keep the keyboard commands the same as well as adding some new.
  58. There are two main differences between PPMore and More, PPMore uses gadgets
  59. and it always loads the complete file in memory (More only loads part of the
  60. file and will load the rest when needed).  If you can live with these
  61. differences, you can replace More with PPMore anywhere you want.
  62.      If you haven't got PowerPacker you are of course missing one of the main
  63. features of this program.  PowerPacker is available as shareware (up to
  64. version 2.3b) or as a commercial program (version 3.0a).  Order a copy for
  65. $17.50 (Europe) or $20 (outside Europe) from UGA, P.O.Box 881, 3700 AW Zeist,
  66. The Netherlands (only Eurochecks in Dutch Guilders or cash).  The commercial
  67. version offers several enhancements like 40 to 50 times faster crunching and
  68. overlay crunching.
  69.  
  70.  
  71. 2. Usage
  72. ========
  73.  
  74.      PPMore can be used in four different ways.
  75.  
  76. - First of all via the CLI:
  77.  
  78.      If you enter PPMore without arguments you will get a usage template.
  79. You use PPMore like this:
  80.  
  81.      PPMore [<options>] [<file|dir>]
  82.  
  83.      The program will then load the ascii file and display it.  If the file
  84. was crunched using PowerPacker 2.0 or higher PPMore will first decrunch it
  85. for you.  If the file was encrypted you will be prompted for the password.
  86.      The '-w' option switches on line wrap mode.  Line wrap mode determines
  87. how long lines will be displayed.  If it is on (default) long lines will
  88. continue on the next line, if it is off they will be cut off.  Press 'w' to
  89. toggle it on/off.  If a line is cut off a complemented '>' will appear on the
  90. right edge of the display.
  91.      The other options are explained in section 4.
  92.  
  93.      PPMore can be made resident so it doesn't have to be loaded every time
  94. you use it, use the ARP ARes command or the c: Resident command for this.
  95. You can't make PPMore resident when it is crunched !!  The file is supplied
  96. as an uncrunched command file with the pure bit set.
  97.      If you enter PPMore without options, you will be presented with a file
  98. requester.  Entering PPMore with a directory instead of a file as an
  99. argument will also get you a file requester, but it will be positioned in the
  100. directory you specified.
  101.      Enter 'PPMore ?' for a little usage message.
  102.  
  103. - Via the WorkBench:
  104.  
  105.      There are three different ways of using PPMore via the workbench: you
  106. can set the default tool of the (crunched) text file to 'PPMore', you can
  107. single click the PPMore icon and then double click the text file icon or you
  108. can double-click the PPMore icon and pick a file using the file requester.
  109.      You set the default tool by single clicking the icon of the text file
  110. and selecting 'Info' from the workbench menu.  You will get a window with
  111. several gadgets in it, click in the string gadget where it says 'Default
  112. tool' and enter ':ppmore'.  PPMore should be in the root directory of your
  113. disk for this to work, if e.g. it's in the system directory you should enter
  114. ':system/ppmore'.  Last of all select the 'Save' gadget.
  115.  
  116. NOTE: - PPMore will add '.pp' to the filename when the file wasn't found.
  117.         This is very useful in the WorkBench enviroment: you can make an
  118.         icon for 'text.doc' but name the file 'text.doc.pp'.  Now the
  119.         WorkBench will show an icon with 'text.doc' as name, but if you
  120.         doubleclick it 'text.doc.pp' will be displayed.  (As long as there
  121.         is no 'text.doc' file in the directory !)
  122.       - Once you are in PPMore press 'L' to load a new file.
  123.  
  124.  
  125. 3. Control
  126. ==========
  127.  
  128.      PPMore can be controlled by keyboard or by intuition gadgets.  To get a
  129. summary of the keyboard commands press <HELP>, the function of the gadgets
  130. shouldn't be hard to understand.
  131.  
  132.      A few notes on printing:
  133.  
  134. - The printer.device has to be in the devs: directory for PPMore to be able
  135.   to print, you should also have a correct system-configuration for your
  136.   printer.
  137.  
  138. - You can continue to read the text when PPMore is printing (this IS a
  139.   multitasking computer ! :-), you can't quit when printing is still in
  140.   progress !
  141.  
  142.  
  143. 4. Using PPMore from other programs
  144. ===================================
  145.  
  146.      If you are not a programmer you can skip this section.
  147.  
  148.      PPMore has two power options to make it possible to use it from other
  149. programs.  This way you don't have to include a text displayer in your
  150. programs, you just execute PPMore with one (or all) of the following options:
  151.  
  152.      -@mem,len,flags[,name]
  153.  
  154.        If you specify this option PPMore will not load a file but instead it
  155.      will display a chunk of memory.  You specify the memory addres and
  156.      length in the command line as well as some flags.  The current version
  157.      only has one flag: PPMORE_FREEMEM = bit 0 of the flag-word = 0x1.
  158.        When this flag is set PPMore will free the memory after it has
  159.      finished, if it isn't set PPMore will just exit and leave the memory
  160.      alone.  This way your program can start PPMore with the PPMORE_FREEMEM
  161.      flag set and exit before PPMore has ended.  PPMore will then free the
  162.      memory instead of your program.
  163.           The address, length and flags must be presented as HEX longwords
  164.      seperated by a comma.  These options can be followed by another comma
  165.      and a string to give the memory chunk a name, if this string is omited
  166.      PPMore will use the name 'memory'.  This string ends with the end of the
  167.      command line so it can contain spaces.
  168.  
  169.      -Sscreen or -S*
  170.  
  171.        With this option you can use PPMore on another screen.  You must
  172.      provide a screen address in HEX.  PPMore will the open the main window
  173.      on this screen.  If you specify a '*' instead of a screen address the
  174.      frontmost screen will be used.
  175.  
  176.      Examples:
  177.  
  178.        o  PPMore -@1A000,1D4E,0,my chunk
  179.  
  180.             PPMore will open a window 'Listing of my chunk', start
  181.           displaying at address 0x1A000 and stop at address 0x1BD4E.  The
  182.           memory will not be freed after PPMore exits.
  183.  
  184.        o  PPMore -Sc2d8a0 -@1A000,1D4E,1,my chunk
  185.  
  186.             Same as previous but now PPMore will free the memory chunk and
  187.           open the main window on the custom screen with the screen structure
  188.           on address 0xc2d8a0.
  189.  
  190.        o  PPMore -S* myfile
  191.  
  192.             Load and display the file 'myfile' and open window on the front
  193.           screen.
  194.  
  195. NOTE: - The options are case sensitive.
  196.       - The @ option must always be the last option on the command line.
  197.       - If you open PPMore on another screen PPMore will not check if the
  198.         screen closes !!  PPMore should always finish before this screen is
  199.         closed !
  200.       - I advise you to use the ARP 1.3 SyncRun and/or ASyncRun instead of
  201.         the AmigaDOS Execute function to execute PPMore from your programs
  202.         because the ARP functions also work when your program has been
  203.         started from WorkBench.  I suppose Kickstart 2.0 will offer some
  204.         better ways of executing programs.
  205.       - Watch out when using these options, it is very easy to crash the Amiga
  206.         if you don't know what you are doing !!!
  207.  
  208.  
  209.                       As always, I hope you find this program useful !
  210.  
  211.  
  212.                               PROGRAM HISTORY:
  213.  
  214. *****************************************************************************
  215. VERSION 1.0
  216.  
  217.      First release.
  218.  
  219. *****************************************************************************
  220. VERSION 1.1
  221.  
  222.      '.pp' suffix added to filename when file not found, very useful in
  223.        WorkBench enviroment.
  224.      PPMore now also loads encrypted files. (PowerPacker 2.3a or higher)
  225.  
  226. *****************************************************************************
  227. VERSION 1.2
  228.  
  229.      Rewritten some routines in assembler, results in a slightly faster
  230.        and smaller PPMore.
  231.      Keyboard input improved. Autorepeat of keys is ignored so you can keep
  232.        on pressing <page down> without typing it 20 times ahead !
  233.      Gadget input also improved, now handles repeat.
  234.      PPMore now prompts for a filename when double-clicked from WorkBench.
  235.  
  236. *****************************************************************************
  237. VERSION 1.3
  238.  
  239.      PPMore can now be made resident and is reentrant. (provided PPMore is
  240.        not crunched)
  241.      Improved error reporting, the main window only opens when PPMore is
  242.        going to display the file.
  243.      File is checked to see if it is an ASCII (text) file.
  244.      Two new power-options for use of PPMore from other programs:
  245.        -@ to display memory, -S to open window on a custom screen.
  246.      Fast assembler search function added.
  247.      Display position is displayed in titlebar (percentage).
  248.      Goto n% function added, replaced 'Refresh' gadget with this function.
  249.      Decrunching is 15% faster.
  250.      'Exit PPMore' only selected when button is released on top of gadget.
  251.      NO bugs removed because none where found. :-)
  252.      Only about 700 bytes larger than version 1.2 !
  253.  
  254. *****************************************************************************
  255. VERSION 1.4
  256.  
  257.      Bug fixed: PPMore 1.3 was not 100% pure, version 1.4 is !
  258.      ASCII check less strict (e.g. now allows files to contain a '©')
  259.      Another 300 bytes shorter than version 1.3 :-)
  260.  
  261. *****************************************************************************
  262. VERSION 1.5
  263.  
  264.      Bug fixed: search/goto window always opened on WorkBench screen.
  265.      Find previous also implemented.
  266.      Load a new file from within PPMore.
  267.      PPMore uses ARP file requester if arp.library is available.
  268.      Line count, as well as goto line.
  269.      Display position as percentage or line number.
  270.      Keypad = movement. (for PC-lovers, yek :-( )
  271.      PPMore now supports all keymaps !! I think especially german and french
  272.        Amiga users will be grateful for this.
  273.      Less than 600 bytes longer than version 1.4 (I love this :-D)
  274.  
  275. *****************************************************************************
  276. VERSION 1.5a
  277.  
  278.      Decrunching is 40% faster, this was a stupid mistake in 1.3 to 1.5,
  279.        I accidently used a slower instead of a faster decrunch routine :-(
  280.  
  281. *****************************************************************************
  282. VERSION 1.5b
  283.  
  284.      The Guru isn't with me lately, after using a slow decruncher in 1.3-1.5
  285.        by accident I now used a fast but faulty decruncher in 1.5a. It
  286.        sometimes didn't decrunch correctly, this has now been fixed. The
  287.        decruncher is still 40% faster than the 1.3-1.5 one. (and it's 2 bytes
  288.        shorter :^D )
  289.  
  290. *****************************************************************************
  291. VERSION 1.6
  292.  
  293.      Bugs in search fixed, didn't work correctly when used in large files and
  294.        sometimes didn't work at all :-(
  295.      Error output goes to the console when you start PPMore from the CLI,
  296.        WorkBench error reporting still in small window as before.
  297.      The ASCII check was made less strict (again).  I got a lot of complaints
  298.        from German users trying to display german documents, this should now
  299.        no longer be a problem.
  300.      If you deactivated the window when PPMore was loading PPMore would hang
  301.        until you resized its window, this has been fixed.  (Actually, I
  302.        worked around this problem, I think it was an Intuition bug :-)
  303.      PgUp, PgDn and the shifted arrow keys now do an immediate page up/down
  304.        without scrolling, SPACE and BS still scroll up/down.
  305.      Changed some things so PPMore runs better on Kickstart 2.0, next
  306.        version of PPMore will probably be a Kick 2.0 only version so I can
  307.        make use of all the new goodies of the new OS :^)
  308.  
  309. *****************************************************************************
  310. VERSION 1.6a
  311.  
  312.      Small update on special request.  Now possible to dump just the visible
  313.        page to the printer instead of the entire file.
  314.  
  315. *****************************************************************************
  316. VERSION 1.7
  317.  
  318.      No Kickstart 2.0 only version yet.  Changed some stuff so PPMore looks
  319.        best on Kick 2.0 and still runs on Kick 1.3.
  320.      Uses the all new powerpacker.library => shorter code :^D
  321.      Starting PPMore from the CLI with a directory as an argument now puts
  322.        up the requester positioned in that directory. Extremely useful once
  323.        you get used to this :^)
  324.      Small bug fixed in search routine, it sometimes missed an occurence.
  325.      PPMore filters out form-feeds and replaces them with <FORM FEED>.
  326.      If you are running Workbench 2.0 PPMore will use the asl.library
  327.        instead of the arp.library (for the filerequester).
  328.      Now fully supports system & screen fonts different than topaz 8.
  329.      Automatic refresh when you resize the window (only on Kick 2.0,
  330.        couldn't be done on 1.3 because of bug in console.device)
  331.      Used different technique to find workbench screen size, using
  332.        NormalDisplayRows no longer seemed to work on 2.0 ?!?!?
  333.  
  334.      REVISION 1.71
  335.      ~~~~~~~~~~~~~
  336.      Percentage background color is now white again on Kickstart 1.3.
  337.      Removed read in low memory when the close gadget was used.  Thanks to
  338.        the enforcer I was able to fix this VERY obscure bug :-)
  339.  
  340. *****************************************************************************
  341. VERSION 1.8
  342.  
  343.      Nicer new-look 3D gadgets in window border for Kickstart 1.3.
  344.      Line wrap on/off implemented.  If switched off causes all lines to be
  345.        cut off at the right edge of the window.
  346.      Seemed that the asl requester no longer worked on the latest
  347.        Kickstart 2.0 (release V37). Fixed.
  348.      Asl requester doesn't show '.info' icon files.
  349.  
  350. *****************************************************************************
  351. VERSION 1.8a
  352.  
  353.      Asl and Arp requester removed.
  354.      PPMore now uses the ReqTools file, long and string requesters from
  355.        reqtools.library.
  356.  
  357. *****************************************************************************
  358.  
  359. PPMore 1.8a written by Nico François (Yes, Nico is my first name :-)
  360.             thanks to Holger Lubitz for the many bug reports :^) and all the
  361.                                     useful suggestions.
  362.  
  363. (c) 1991 Nico François
  364.  
  365.                                    //
  366.                        Thanks to \X/ Amiga for being the best computer ever !
  367.  
  368.